SETTING STARTED 


Congratulations» you are now the owner of what we at OSS feel is one of the 
finest System Software Packades available for your Apple. The following 
information will hele you get this system on-line as quickly as possible, 
Once vou have completed the sters on this rade, you can start digesting 

the manuals and discovering all the wondeful things you can do with this 
system. 


UNPACKING? 
Your OSS Software Package should contain the followings? 


1) Software License Asreement. 
This form showld be signed and returned to OSS immediately. Aside 
from its obvious Furrose, it will rut vou on the OSS mailing list 
for user notes, future rroduct announcements, etc, 

2) Bus Rerort, Sheet. 
This form is to be used for rerorting any problems that you may 
find in the OSS software or its documentation. We hore that wou 
will never need to use this form howevery we are sincerly interested 
in finding and fixing 311 rroblems. 

3) Mini-Dliskette, 
This diskette contains your OSS Software. In the urrer right hand 
corner of the label is your diskette serial numbers this number 
should corresrond to the number on your license agreement. The 
serial number besins with one or two aleha characters that define 
the tyre of software ordered? t 

CPnonnn ~ Orerating Sustem only 
EBnnnrm - Orerating Systems BASICy and EASMD 
Ennnnm - Orerating System and EASMID 
Brnnn - Oreratins System and BASIC 

4) CF/Ay Orerating System » and Disk File Manager Manual, 

S) BASIC Manual (If BASIC was ordered). 

5S) EASMD Manual (If EASMD was. ordered), 


BRINGING UP THE SYSTEM? 


1) Disk Controller Card must be in Slot number 6. 
2) Insert Diskette into Drive number 1, 
3) If you have the Auto Start ROMy turm Fower ons otherwiser 
ture 6-control-F, 
4) The OSS System will booty clear the screen: and display! 
OSS CF/A — VERSION 1.0 


A.<cursor> 


5) Type DiR<return> to list the diskette directory. 
6) If you ordered BASIC, the file "BASIC COM" will be included. 
7) If you ordered EASMI» the file "EASMD COM* will be included. 


If you are missing any itemss or if your system has not rerformed 
as above, notify your dealer or OSS immediatly. Good luck and 
harry Programming, 
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OPTIMIZED SYSTEMS SOFTWARE 


OSS CP/A 


The OSS Control Program/Apple is a general purpose keyboard- 
oriented command and control program which gives the user a 
simple and consistent interface with OSS OS. In addition 

to the several powerful intrinsic commands noted below, the 

user may call for any system utility program by simply entering 
the program's name. Thus, for example, OSS BASIC is called forth 
from CP/A by simply typing "BASIC". 


The intrinsic commands currently implemented include: 


DIRectory SAVe 
LOAd RUN 
ERAse PROtect 
UNProtect REName 
A: B: 


By combining CP/A's ability to call a program and pass the 
user's command line with OS's ease of interface to devices and 


files, the user may easily implement customized "commands". 


tcl Shepardson 
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OPTIMIZED SYSTEM SOFTWARE 
OSS 6502 OPERATING SYSTEM 


The OSS Operating System provides a device independent user interface 
to the various system I/O devices. An application program, such as 
Basic, issues device independent I/O commands to the operating system. 
The operating system validates the commands and interacts with the 
device I/O drivers to fulfill the user I/O request. The user request 
single bytes or multiple bytes of data transfer from the operating 
system without being concerned about the actual mechanics of the I/0 
operation. Basic, for example, can instruct the operating system to 
get an entire input line from the keyboard, disk, or a data communi- 
cations interface with exactly the same command format. 


The various system I/O devices are attached to the operating system 
via simple device drivers. Each device driver has a unique name. 
The device driver name allows the user to specify to the operating 
system which I/O device he wishes data transfer to or from. The 
Apple OSS operating system has a number of predefined devices: 


E: - The Apple Screen Editor. 
A:,B: - Disks A and B (via the file manager) 
Pn: - 1/0 ports 1 through 7 


The user may also add device drivers to meet his own particular 
needs. 


GEE Sheparison 
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OPTIMIZED SYSTEMS SOFTWARE 
OSS 6502 BASIC 


The OSS Basic has been designed with the commerical user in mind. Some 
of the features of this Basic include true decimal arithmetic, 32K byte 
string sizes, flexible I/O statements, long variable names (up to 255 
significant characters), and overlay capabilities. 


Virtually all 6502 Basics use binary floating point arithmetic. The use 
of monetary values with binary floating point can lead to conversion 
inaccuracies. These conversion inaccuracies do not exist when using 
decimal floating point. If you require monetary accuarcy, OSS Basic is 

a Must. 


The commerical user must often deal with large quantities of text. The 
OSS Basic allows each and every string to extend to 32K characters. All 
other 6502 Basics limit an individual string to 256 characters. The OSS 
Basic provides a simple and easy to use string statement to access any 
part of a string or the entire string as a unit. 


The OSS Basic I/O statements are not of the format found in other Basics 
in use on the Apple. The OSS Basic I/O statement have been designed to 
allow convenient I/O access. The example shows a string being retrieved 
from the disk and printed to an external printer and to the TV Screen. 

OPEN #2, INPUT, 0, "Dl: DATA.TXT" (a data file on disk 1) 

OPEN #3, OUTPUT, 0, "P1:" (the printer, in slot 1) 

INPUT #2, A$ 

PRINT #3, A$ 

PRINT A$ 


This same task in an Apple Basic would look like: 


PRINT "“cnt1-D": "OPEN DATA TXT" 
PRINT “cntl-D": "READ DATA TXT" 


INPUT AS 
PRINT "“cntl-D": "PR#2" 
PRINT A$ 
PRINT "“cnti1-D": "PR#0" 
PRINT A$ 


It can be readily seen that OSS Basic was designed with I/O convenience 
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OPTIMIZED SYSTEMS SOFTWARE 
OSS 6502 ASSEMBLER/EDITOR/ DEBUG 


The assembler package is a complete utility that will allow the user to 
write and debug assembly language programs. The Editor is used to build 
text files, the Assembler assembles the program and the DEBUG facility 
allows the user to debug the program. 


The Editor has a complete set of text manipulation commands. The Commands 
include LIST, FIND, REPLACE, DELETE, PRINT and LOAD. The Editor can also 
be used to edit non-assembly language text, such as BASIC programs and 
general text. 


The Assembler is a complete 6502 assembler. The assembler mnemonics and 
operands are as specified by MOS Technology for the 6502. The user may 
assemble the object directly to memory or store it on the disk for later 
use. 4 

\ 
The Debug package contains all the tools necessary to debug an assembly 
language program. The user can load machine language from the disk, run 
it, modify it and re-save it. Portions of the program may be disassembled 
via the disassembler and modified via the mini-assembler. The user can 
effect controlled execution of the program via breakpoints and STEP and 
TRACE functions. The users of the Apple Auto-Start ROM will appreciate 
the regaining of these important debug functions. 


Ge Shepardson 
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SOFTWARE LICENSE AGREEMENT SERIAL NUMBER 


IMPORTANT: READ THIS LICENSE AGREEMENT 
CAREFULLY BEFORE OPENING THIS PACKAGE. 

IF YOU DO NOT AGREE TO THESE TERMS, RETURN 
THIS SHEPARDSON MICROSYSTEMS SOFTWARE 
PACKAGE UNOPENED TO YOUR DISTRIBUTOR AND 
YOUR LICENSE FEE WILL BE REFUNDED. 


SHEPARDSON MICROSYSTEMS Software is licensed by SHEPARDSON MICROSYSTEMS to customers only on the 
condition that the Customer agrees to the terms set forth in this agreement. If you agree to these 
terms, you must fill out the enclosed registration form and return it to SHEPARDSON MICROSYSTEMS 

by mail before using the enclosed SHEPARDSON MICROSYSTEMS Software. This license Agreement applies to 
all SHEPARDSON MICROSYSTEMS Software. "SHEPARDSON MICROSYSTEMS Software" includes the object code for 
SHEPARDSON MICROSYSTEMS Software computer programs, whether supplied on an 8-inch or 5-inch floppy 
diskette or any other medium, and all associated documentation provided by SHEPARDSON MICROSYSTEMS. 


1) LICENSE. SHEPARDSON MICROSYSTEMS agrees to grant and the customer agrees to accept on the following 
terms and conditions a nontransferable and nonexclusive license to use the SHEPARDSON MICROSYSTEMS 
Software enclosed with this agreement. 


2) RESTRICTIONS ON THE USE: This license authorizes the Customer to use the SHEPARDSON MICROSYSTEMS 
Software programs in object code form only and only on the single computer system designated on the 
Customer's registration form A separate license is required for each system on which SHEPARDSON 
MICROSYSTEMS Software is to be used. Neither the license granted under this agreement nor the 
SHEPARDSON MICROSYSTEMS Software to which it applies may be assigned, sublicensed or otherwise trans- 
ferred by the Customer without the prior written consent of SHEPARDSON MICROSYSTEMS. 


3) BACK-UP COPIES OF PROGRAMS: The Customer may make, back-up copies of SHEPARDSON MICROSYSTEMS Software 
Programs as required for Customer's own use only, provided that the Customer must maintain appropriate 
records of the number and location of all such copies. The original and alt copies of SHEPARDSON 
MICROSYSTEMS Software programs, or any part thereof, made by the Customer shall be the property of 
SHEPARDSON MICROSYSTEMS. This does not imply, of course that SHEPARDSON MICROSYSTEMS owns the media 
on which the programs are recorded. 


4) COPIES OF PRINTED MATERIALS: The Customer may not copy, in whole or in part, any SHEPARDSON MICROSYSTEMS 
Software program, documentation or related materials provided by SHEPARDSON MICROSYSTEMS in printed form. 
Additional copies of such printed materials may be obtained from SHEPARDSON MICROSYSTEMS at SHEPARDSON 
MICROSYSTEMS' standard published rates. 


5) COPYRIGHT NOTICES AND LEGENDS: SHEPARDSON MICROSYSTEMS Software is copyrighted by SHEPARDSON 
MICROSYSTEMS and, in some cases, by SHEPARDSON MICROSYSTEMS' software suppliers. The Customer agrees 
not to remove any copyright notices or any confidential or proprietary legends from any SHEPARDSON 
MICROSYSTEMS Software, and the Customer agrees to reproduce such notices and legends on any copies or 
modifications of SHEPARDSON MICROSYSTEMS Software made by the Customer as permitted herein. 


6) NONDISCLOSURE: The Customer agrees not to provide, disclose or otherwise make available any 
SHEPARDSON MICROSYSTEMS Software to any person other than the Customer or its employees for purposes 
necessary to the Customer's use of the SHEPARDSON MICROSYSTEMS Software as authorized herein. The 
Customer further agrees that all copies of SHEPARDSON MICROSYSTEMS Software will be strictly safeguarded 
against disclosure to or use by any persons not authorized by SHEPARDSON MICROSYSTEMS to use such 
SHEPARDSON MICROSYSTEMS Software and that the Customer will take such steps as are necessary to insure 
that the provisions of this agreement are not violated by any employee of the Customer. The Customer 
recognizes that any unauthorized copying or disclosure of SHEPARDSON MICROSYSTEMS Software will cause 
great damage to SHEPARDSON MICROSYSTEMS and that this damage may greatly exceed the license fee paid 
by the Customer and that injunctive relief may be appropriate to prevent such unauthorized copying or 
disclosure. 
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7) TERM: The license granted under this agreement is effective from the date in which the Customer 
opens this SHEPARDSON MICROSYSTEMS Software package and shall remain in force until terminated as 
provided below. The Customer may terminate this license at any time upon one months’ written notice 
to SHEPARDSON MICROSYSTEMS. SHEPARDSON MICROSYSTEMS may terminate this license at any time if the 
Customer fails to comply with any of the terms of this agreement. 


8) TERMINATION: Within one month after the date of termination of the license granted under this 
agreement, the Customer will furnish SHEPARDSON MICROSYSTEMS a certificate certifying that through 
the Customer's best efforts and to the best of the Customer's knowledge, the original and all copies, 
in whole or in part, in any form, of the SHEPARDSON MICROSYSTEMS Software have been returned to 
SHEPARDSON MICROSYSTEMS or destroyed. 


9) ENHANCEMENT AND UPDATES: From time to time, SHEPARDSON MICROSYSTEMS may advise customers who have 
completed registration forms and returned them to SHEPARDSON MICROSYSTEMS of enhancements and updates 
to the SHEPARDSON MICROSYSTEMS Software. 


10) LIMITATIONS OF WARRANTY AND LIABILITY: SHEPARDSON MICROSYSTEMS MAKES NO WARRANTIES, EITHER EXPRESS 
OR IMPLIED, WITH RESPECT TO THE SHEPARDSON MICROSYSTEMS SOFTWARE, ITS QUALITY ,PERFORMANCE, 
MERCHANTABILITY, OR FITNESS FOR ANY PARTICULAR USE. SHEPARDSON MICROSYSTEMS SOFTWARE IS LICENSED "AS IS" 
AND WITH ALL FAULTS. IN NO EVENT WILL SHEPARDSON MICROSYSTEMS BE LIABLE FOR DIRECT, INDIRECT, INCI- 
DENTAL OR CONSEQUENTIAL DAMAGES RESULTING FROM ANY DEFECT IN THE SHEPARDSON MICROSYSTEMS SOFTWARE EVEN 
IF SHEPARDSON MICROSYSTEMS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT 
ALLOW THE EXCLUSION OR LIMITATION OF IMPLIED WARRANTIES OR LIABILITY FOR INCIDENTAL OR CONSEQUENTIAL 
DAMAGES, SO THE ABOVE LIMITATION MAY NOT APPLY TO SOME CUSTOMERS. 


SHEPARDSON MICROSYSTEMS, INC. 


SOFTWARE REGISTRATION FORM 


SHEPARDSON MICROSYSTEMS Software: 


Software Serial Number: 


Computer System: 


Computer System Serial Number: 


Software Obtained From: 


(Name of Dealer) 


(Address of Dealer) 


Date of Customer's Receipt of Software: 


Location where SHEPARDSON MICROSYSTEMS Software will be used: 


As the authorized representative of the Customer named below, I agree tothe 
terms and conditions of the SHEPARDSON MICROSYSTEMS Software License Agree- 
ment enclosed with the above SHEPARDSON MICROSYSTEMS Software. 


Signature of Representative 


Name of 
Representative: 


Name of Customer: 
Address of Customer: 


City, State, Zip: 


Please return this to: 


SHEPARDSON MICROSYSTEMS, INC. 
20395 Pacifica Dr., Ste. 108 
Cupertino, CA 95014 


OSS BUG REPORT SHEET 


lear OSS Customers 


Have you found a bus im the software or an error in the manual? 
We would like to hear about it. Is there a feature or @ new 
Froduct you would like to see in our software reckade? We 

want to hear that, too. 


In rerorting @ buss elease include es much information 
as rossible. Any or all of the following may be useful: 


1. Program froducts you were usims when the 
Froblem occurred, (BASIC» CF/A» INIT: etc) 

2. Listing/diskette 

3. Exact seauence of events that led to the 
eroblem., (Most useful - if we can’t rerroduce 
the wroblems we can’t fix it.) 

4. Ture of peripherals being used when the 
Froblem occurred. 

5. System configuration (autostart roms number 
of disks» ete) 

6. Any user~added device handlers? 

7. Your names rhone number, and address, 
(entirely ortional) 


Send to? 


SHEFARDSON MICROSYSTEMS, INC 
OPTIMIZED SYSTEMS SOFTWARE 
20395 PACIFICA DR. SUITE 108 
CUPERTINO, CA 95014 


Thank Yous 
oss 


